home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / turbovis / ptg120co.zip / PTG_USER.DOC < prev    next >
Text File  |  1993-11-06  |  48KB  |  1,561 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.             ▀▀▀▀▀   ▀    ▀▀▀▀▀
  15.            ▀▀   ▀▀  ▀▄  ▀▀        ▀▀   ▀  ▀
  16.            ▀▀▀▀▀▀  ▄▀  ▀▀▀  ▀▀▀▀ ▀▄▄▀ ▀ ▀ ▀
  17.            ▀▀       ▀   ▀▀   ▀▀  ▀    ▀  ▀▀   1.20
  18.            ▀▀        ▀▀   ▀▀▀▀▀    ▀▀  ▀   ▀
  19.  
  20.  
  21.            (c) Copyright 1991, 1993 by Nederware, a dutch software company
  22.  
  23.  
  24.            User's Guide
  25.  
  26.  
  27.            written by Berend de Boer
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                       DISCLAIMER
  34.  
  35.           NEDERWARE PROVIDES THE SHAREWARE VERSION OF PTGEN "AS IS" AND
  36.           WITHOUT ANY WARRANTY. TO THE EXTENT PERMITTED UNDER APPLICABLE
  37.           LAW, NEDERWARE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
  38.           INCLUDING BUT NOT LIMITED TO, ANY IMPLIED WARRANTY OF MERCHAN-
  39.           TABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SPECIFICALLY,
  40.           NEDERWARE MAKES NO REPRESENTATION OR WARRANTY THAT THE SOFTWARE
  41.           IS FIT FOR ANY PARTICULAR PURPOSE.
  42.  
  43.           NEDERWARE SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE
  44.           USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, LOSS OF
  45.           PROFIT, DATA OR USE OF THE SOFTWARE, OR SPECIAL, INCIDENTAL OR
  46.           CONSEQUENTIAL DAMAGES OR OTHER SIMILAR CLAIMS, EVEN IF NEDERWARE
  47.           HAS BEEN SPECIFICALLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                               PtGen user manual - page i
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                                   TABLE OF CONTENTS
  93.  
  94.  
  95.           LICENSE . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
  96.  
  97.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   1
  98.                Assumptions  . . . . . . . . . . . . . . . . . . . . . .   1
  99.                About PtGen  . . . . . . . . . . . . . . . . . . . . . .   1
  100.                Features . . . . . . . . . . . . . . . . . . . . . . . .   1
  101.                TVTool . . . . . . . . . . . . . . . . . . . . . . . . .   1
  102.                Acknowledgements . . . . . . . . . . . . . . . . . . . .   2
  103.  
  104.           INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .   3
  105.                The READ.ME file . . . . . . . . . . . . . . . . . . . .   3
  106.                Installation on harddisk . . . . . . . . . . . . . . . .   4
  107.                Environment variables  . . . . . . . . . . . . . . . . .   4
  108.                Installation under Tools menu of Borland IDE . . . . . .   4
  109.  
  110.           PtGen DEVELOPMENT-CYCLE . . . . . . . . . . . . . . . . . . .   5
  111.                PtGen development-cycle  . . . . . . . . . . . . . . . .   5
  112.                Ptgen single dialog box creating mode  . . . . . . . . .   5
  113.  
  114.           THE FILES CREATED BY PtGen  . . . . . . . . . . . . . . . . .   7
  115.                The Source File  . . . . . . . . . . . . . . . . . . . .   7
  116.                DEFINES.DEF  . . . . . . . . . . . . . . . . . . . . . .   7
  117.                STRRESFS.TVR . . . . . . . . . . . . . . . . . . . . . .   7
  118.                STRINGS.TVR  . . . . . . . . . . . . . . . . . . . . . .   8
  119.                STRINGS.INC  . . . . . . . . . . . . . . . . . . . . . .   8
  120.  
  121.           GENERAL OPERATION PRINCIPLES  . . . . . . . . . . . . . . . .   9
  122.                Mouse operation  . . . . . . . . . . . . . . . . . . . .   9
  123.                Keyboard operation . . . . . . . . . . . . . . . . . . .   9
  124.  
  125.           SAMPLE APPS . . . . . . . . . . . . . . . . . . . . . . . . .  10
  126.                Creating a menubar and a statusline  . . . . . . . . . .  10
  127.                Creating a dialog box  . . . . . . . . . . . . . . . . .  13
  128.  
  129.           CREATING AN EXECUTABLE  . . . . . . . . . . . . . . . . . . .  17
  130.                A simple main  . . . . . . . . . . . . . . . . . . . . .  17
  131.                A more advanced main . . . . . . . . . . . . . . . . . .  17
  132.  
  133.           MORE ADVANCED TOPICS  . . . . . . . . . . . . . . . . . . . .  19
  134.                Using string resource files  . . . . . . . . . . . . . .  19
  135.                Adding units . . . . . . . . . . . . . . . . . . . . . .  19
  136.  
  137.           Appendix A: Command line options  . . . . . . . . . . . . . .  20
  138.  
  139.           Appendix B: Environment variables . . . . . . . . . . . . . .  21
  140.  
  141.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  142.  
  143.  
  144.  
  145.                              PtGen user manual - page ii
  146.  
  147.  
  148.  
  149.  
  150.  
  151.                                        LICENSE
  152.  
  153.  
  154.           Copyright 1991, 1993 by Nederware. All rights reserved.
  155.           COMMERCIAL DISTRIBUTION PROHIBITED WITHOUT WRITTEN CONSENT FROM
  156.           THE AUTHOR.
  157.           This version of PtGen is NOT public domain or free software, but
  158.           is being distributed as "shareware" for EVALUATION PURPOSES ONLY.
  159.  
  160.           1)   You may copy and distribute copies of the PtGen source,
  161.                documentation, and executable code as you receive it, in any
  162.                medium, provided that you conspicuously and appropriately
  163.                publish on each copy a valid copyright notice "Copyright
  164.                1992 by Nederware"; keep intact the notices on all files
  165.                that refer to this License Agreement and to the absence of
  166.                any warranty; PROVIDE UNMODIFIED COPIES OF THE DOCUMENTATION
  167.                AS PROVIDED WITH THE PROGRAM; and give any other recipients
  168.                of the PtGen program a copy of this License Agreement along
  169.                with the program. You may charge a distribution fee for the
  170.                physical act of transferring a copy, but no more than is
  171.                necessary to recover your actual costs incurred in the
  172.                transfer. Under no circumstances is PtGen to be distributed
  173.                in such a way as to be construed as "value added" in a sales
  174.                transaction, such as, but not limited to, software bundled
  175.                with any other program without the prior written consent of
  176.                the author.
  177.  
  178.           2)   You may use PtGen for a 30-day evaluation period on a
  179.                private, non-commercial basis, for the express purpose of
  180.                determining whether PtGen is suitable for your needs. At the
  181.                end of this 30-day evaluation period, you must either
  182.                purchase a license from Nederware for continued use of
  183.                PtGen, or discontinue using PtGen. See REGISTRATION.FRM for
  184.                details about purchasing a license.
  185.  
  186.           3)   As a user with license you are entitled to FREE updates
  187.                until the next major version. Versions can be differentiated
  188.                by their version number. The version number of your copy of
  189.                PtGen is listed in the about dialog box of PtGen.
  190.                A next major version differs from the previous major version
  191.                by changing of the number before the point in the version
  192.                number. Say you have version 1.4. If you want to use PtGen
  193.                2.1 you have to buy a new license. Licensed users get 50%
  194.                reduction in the price of the major version they want to
  195.                use.
  196.                FREE updates is FREE of extra cost outside shipping and
  197.                handling, usually not more than $10.00. If you have
  198.                CompuServe access it is possible to upload new software to
  199.                you using CompuServe's binary file transfer function. The
  200.                total cost of this process is for the user. The cost of this
  201.                is estimated to be about $6.00.
  202.  
  203.  
  204.                              PtGen user manual - page iii
  205.  
  206.  
  207.  
  208.  
  209.  
  210.           4)   If you use this software for private, personal, non-
  211.                commercial means only then you may purchase this product at
  212.                a chepar rate. Non-commercial is: you're not using this
  213.                software for any purpose that is linked with commercial or
  214.                non-personal leisure activities of any kind. Commercial or
  215.                non-personal leisure activities include activities related
  216.                to any of your jobs wherefore you receive money.
  217.                Conta